home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / condor2.zip / CPAINT.DOC < prev    next >
Text File  |  1993-05-29  |  18KB  |  383 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    CONDOR PAINT
  8.                Copyright 1993 by Larry Mears
  9.                    All Rights Reserved
  10.                    version  1.0
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.     Disclaimer:  There is no gaurantee as to the performance of
  24.              CONDOR PAINT.  The user assumes ALL risks involved
  25.              from the use of CONDOR PAINT.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                      INDEX
  33.  
  34.     Description   .................................................... 1
  35.  
  36.     Using CPaint  .................................................... 1
  37.  
  38.     The MAIN Menu .................................................... 2
  39.  
  40.     QUIT  ............................................................ 2
  41.  
  42.     FILE  ............................................................ 2
  43.  
  44.     NEW   ............................................................ 2
  45.  
  46.     COLOR ............................................................ 2
  47.  
  48.     DRAW  ............................................................ 3
  49.  
  50.     PLOT  ............................................................ 3
  51.  
  52.     FILL  ............................................................ 3
  53.  
  54.     CIRCLE  .......................................................... 4
  55.  
  56.     RECT    .......................................................... 4
  57.  
  58.     SOLIDS  .......................................................... 4
  59.  
  60.     TEXT    .......................................................... 5
  61.  
  62.     SOUND   .......................................................... 5
  63.  
  64.     UNDO    .......................................................... 5
  65.  
  66.     EXTRA   .......................................................... 5
  67.  
  68.     CPaint Memory    ................................................. 5
  69.  
  70.     PAUSE   .......................................................... 5
  71.  
  72.     PLAY Graphic     ................................................. 5
  73.  
  74.     Position Cursor  ................................................. 6
  75.  
  76.     Last Words       ................................................. 6
  77.  
  78.  
  79.                     - 1 -
  80.  
  81.           Condor Paint ( CPaint ) creates a ascii text file of graphic
  82.     commands in the correct syntax required by the CONDOR.SYS con: device
  83.     driver.  CPaint requires that CONDOR.SYS be installed to function
  84.     correctly.  Since CPaint isn't simply altering screen memeory don't
  85.     expect it to function as other Paint programs you might use.  What
  86.     CPaint is doing for you is a lot harder to accomplish,  it makes a
  87.     command for the action you selected from the menu and creates
  88.     coordinates for that command from the mouse position.  Erasing is
  89.     accomplished by deleting (Undoing) the last command created. CPAINT.EXE
  90.     will look for GFABASIC.OVL when ran,  put this in the same directory
  91.     as CPAINT.EXE or in a included directory in your PATH statement.
  92.     You must have a MOUSE to use CPaint.
  93.  
  94.          You can use CPaint to make online graphics, pictures, art,
  95.     advertisements, comics, BBS menus, whatever you like.  These
  96.     graphics are displayable from DOS with just the TYPE command if
  97.     the CONDOR.SYS is installed, really far out!!!  CPaint will
  98.     check your free memory and adjust it's buffer to that, the more free
  99.     memory you have the bigger more detail CPaint pic you can create.
  100.     CPaint may not be able to load and work with "any"  CONDOR.SYS format
  101.     graphic due to the limitations imposed by the language CPaint was
  102.     written in, CPaint is intended to create and work with CONDOR files
  103.     CPaint has created only.  You can use a text editor and load CPaint
  104.     files to hand edit.  The CONDOR graphics script looks like a bunch
  105.     of letters and numbers, if you refer to the CONDOR.DOC (the manual)
  106.     you will be able to look these these letters (commands) up and see
  107.     what CPaint is doing.  A human is smarter than CPaint any day and can
  108.     out do CPaint with a little effort and a text editor.  The & loop
  109.     command can provide a lot of punch but is to complex for CPaint to
  110.     handle, but YOU can do it!  You can do some really sharp work just
  111.     using CPaint though.
  112.  
  113.          When CPaint is ran from DOS, not recomended to run from WINDOWS,
  114.     you will get the title screen and a note about 2 BUTTON exit.  A
  115.     2 BUTTON EXIT is simply this: PRESS and HOLD the right mouse button
  116.     and while holding down the right mouse button also press the left
  117.     mouse button then release both.  This is used as a EXIT to the
  118.     MAIN MENU in CPaint.  From the title screen however just CLICK on the
  119.     OK button.  The next thing that confronts you is a RESOLUTION
  120.     selection menu.  You must select a resolution the abort won't work
  121.     from here.  The format for instance 320x200x256 means 320 pixels(dots)
  122.     across ( know as the X coordinate ) and 200 pixels tall ( know as the
  123.     Y coordinate ) and the last part means the number of colors, 256 in
  124.     this example, 320x200x256 a VGA mode and requires a VGA graphics card.
  125.  
  126.  
  127.                     - 2 -
  128.  
  129.     The MAIN Menu will now come up.  Here's a breakdown:
  130.  
  131.     QUIT - Exit CPaint, go back to DOS.
  132.  
  133.     FILE - Use this selection to LOAD a CPaint file or SAVE a CPAINT file.
  134.            No backup files are created and if a file name exists already
  135.            it will be over written without warning.  When a file is loaded
  136.            from here the current picture you are drawing will be wiped out.
  137.            The EXIT command takes you back to the MAIN menu.
  138.  
  139.     NEW - This allows you to start a new pic in a different resolution than
  140.           the one selected when CPaint was first ran.  The current picture
  141.           will be wiped out, so remember to SAVE it from the file menu.
  142.           You can select ABORT and go SAVE it first, or maybe you want to
  143.           start with a clean screen and empty buffer in the same resolution
  144.           in effect killing the drawing you were working on, the NEW option
  145.           does this.
  146.  
  147.     COLOR This alters the color you are working with and or changes a
  148.           color to another from the color palette.   The options can vary
  149.           from this selection depending on the resolution you are using.
  150.           A sub menu will pop up from this menu, then you select what you
  151.           want to use the color, POINTS, LINES, FILLS, TEXT, or PALETTE to
  152.           alter the color palette.  After clicking on points, lines, fills,
  153.           or text you will see a color bar, click on the color you want
  154.           to use for the previous selected drawing operation.
  155.  
  156.          If you select PALETTE and are in a CGA mode you are given
  157.           the option to alter FOREGROUND or BACKGROUND color. If you pick
  158.           BACKGROUND then next click on the ALTER button till you get the
  159.           color you want then click on OK.  If you select FOREGROUND
  160.           click on ALTER and then OK when it's what you want.
  161.  
  162.          In 2 color screen modes and modes 320x200x16 and 640x200x16
  163.           the PALETTE option has no effect.  You can not change the
  164.           Palette for these modes.
  165.  
  166.          In the EGA 640x350x16 and VGA 640x480x16 modes when you click
  167.           on PALETTE you will get the options BORDER or SCREEN.  If you
  168.           select BORDER just CLICK on the ALTER button till you get the
  169.           border(outer most screen edge) you like then click on OK.
  170.           If you select SCREEN then click on the color in the color bar
  171.           that you wish to ALTER, then click on ALTER over and over till
  172.           you get what color you desire the click on OK.  You have to
  173.           still reselect COLOR from MAIN and tell what to use this
  174.           new color for POINTS, LINES, FILLS, or TEXT.
  175.  
  176.         If you are using VGA mode 320x200x256 and select PALETTE you
  177.           will see a mesh of 256 colors, click on the one you wish to
  178.           alter, then you will see a slide bar CLICK on the BAR to
  179.           adjust the color level.  Press the RIGHT mouse button to
  180.           toggle to RED, GREEN or BLUE.  Click on OK when you get
  181.           the color mixture you need or do the 2 button exit to abort.
  182.           You still have to reselect the COLOR option from the MAIN menu
  183.           tell CPaint what you want to use this new color for,
  184.           POINTs, LINEs, FILLs, or Text.
  185.  
  186.  
  187.                     - 3 -
  188.  
  189.     DRAW -   You select this function from the MAIN menu to draw lines.
  190.            You should select COLOR first to set a COLOR for the lines
  191.            you will be drawing.  The draw routine is designed to draw
  192.            lines in a flowing motion of the mouse, so sometimes it's a
  193.            little cranky to get the line started.  Move the mouse
  194.            slightly then press the left button to anchor the line,  now
  195.            just move the mouse around till you get the other end point
  196.            of the line where you want it and press the left mouse button
  197.            to make the line permanent.  Once you anchor a line down you
  198.            can change the lines anchor point by hitting the right mouse
  199.            button.  To exit to the main menu you must use the
  200.            2 BUTTON EXIT: press and hold the right mouse button then while
  201.            holding that button also press the left mouse button, then
  202.            release both.
  203.  
  204.     PLOT -   This will plot a point at the location of the mouse pointer
  205.            when the left mouse button it pressed.  You should use the
  206.            COLOR option from the MAIN menu to set the color to use for the
  207.            points you are plotting.  DO NOT use this command to draw with,
  208.            while it's possible it will make your picture really big and a
  209.            lot slower.  I would only use this to plot stars in the sky,
  210.            or hit a few points where a FILL may have missed.  Use the
  211.            2 button exit to get back to the MAIN menu.
  212.  
  213.     FILL -   This fills a area with the Fill COLOR you selected from the
  214.            COLOR menu.  The first four options are a border fill, you
  215.            specify what you want to border the fill with.  This is the
  216.            CURRENTLY selected color for POINTs, LINEs, FILLs, or TEXT.
  217.            This fill can leak out even if just ONE dot is missing in a
  218.            border.  ALL colors within the border are replaced with the
  219.            current FILL color.  The last option in the FILL MENU called
  220.            "Interior Color" produces a different type of fill operation.
  221.            This fill gets the color where the fill begins at and replaces
  222.            ONLY that color with the currently selected FILL color.  The
  223.            range of this fill is to the edge of the color it is replacing.
  224.            To FILL a area just select the BORDER type from the menu then
  225.            click on the area to FILL, a 2 button exit takes you back to the
  226.            MAIN menu.
  227.  
  228.  
  229.                     - 4 -
  230.  
  231.     CIRCLE -   This pulls up a menu with 2 options, Condor Circles and
  232.         Plotted Ovals.  The Condor Circle's color is determined by
  233.         what color is selected for LINEs, although if you are drawing
  234.         a disc the interior color is the selected FILL color.  Condor
  235.         Circles are done internally take just a few bytes to produce
  236.         and are draw very fast, their drawback is that there is no
  237.         aspect ratio, so the best looking Condor Circles drawn will be
  238.         in the 320x200 and 640x480 screen resolutions.  I tried real
  239.         hard to include aspect ratios but dos would always lock up!
  240.         The other option Plotted OVALS will produce a OVAL and there
  241.         by you can have perfect circles in any mode with this command.
  242.         The color of the PLOTTED Oval is the color you select from the
  243.         color MENU for POINTs.  Plotted Ovals are just that CPAINT
  244.         does all the math to figure out the coordinates for each point
  245.         plotted and produces a CONDOR Plot command for each one.  This
  246.         is slow but fast online because the math is already done, BUT
  247.         it is very memory hungry and if the Oval is large the CPaint
  248.         picture    will be very large and that means time. The
  249.         Plotted Oval command should be used only if absolutely needed!
  250.            After you select the type of circle you want to draw just
  251.         move the mouse arrow around and click the left mouse button to
  252.         anchor the center of the circle, then move your mouse up and
  253.         down to set the diameter of the circle.  When you get the size
  254.         circle you want click on the left mouse button to make the
  255.         circle permanent.  If you click the right mouse button you can
  256.         reposition the center of the circle.  To abort or exit the
  257.         the circle drawing do a 2 button exit.
  258.  
  259.     RECT -    RECTANGLES   This will first pull up a menu with 2 options.
  260.         With the first option "PIXELS" you move the mouse arrow
  261.         then click the left button to anchor the upper left corner of
  262.         the rectangle, then you can stretch a rectangle to the size you
  263.         need and click the left mouse button again to make it
  264.         permanent.  A right mouse button click will allow you to
  265.         reposition the upper left corner of the rectangle.  You do the
  266.         2 button exit to get back to the main menu.  The color of the
  267.         PIXEL rectangle is determined by the current LINE color.  if
  268.         you are drawing a SOLID rectangle the interior color is the
  269.         current FILL color.
  270.           The second option for rectangle is the "CHARACTER" option.
  271.         When you click on this you will see a text information line in
  272.         upper left section of the screen.  Move your mouse left and
  273.         right to obtain the ASCII character you want to make the
  274.         rectangle with then click the left mouse button.  Move the
  275.         mouse to put the upper left corner of the rectangle where you
  276.         want it then click the left mouse button.  Now move the mouse
  277.         right, left, up, down to see the four corners of the rectangle.
  278.         When you get it the size you want press the left mouse button.
  279.         It will draw a rectanglar area consisting of the character you
  280.         chose.  This command is great to FILL a large area FAST!
  281.         The ASCII character number 219 is great for this.  You can use
  282.         the slower graphic fill command to catch the edges.  To go to
  283.         the MAIN menu do a 2 button exit.
  284.  
  285.     SOLIDS -   This menu entry selects whether a rectangle or circle will
  286.          be filled using with the current fill color, after a circle or
  287.          rectangle is draw using the current line color.
  288.          The Plotted Oval is not affect by this setting and the
  289.          default setting is HOLLOW at startup.  Just click the
  290.          left mouse button on the setting you want SOLID or HOLLOW.
  291.  
  292.  
  293.                     - 5 -
  294.  
  295.     TEXT -     Selecting this menu entry allows you to type a sentence
  296.          up to 128 characters in length.  You can edit this sentence
  297.          using the ARROW keys and the INSERT and ESC keys.  Hit ENTER
  298.          when you finish typing your sentence.  Use the mouse to
  299.          position this sentence where ever you like and press the
  300.          left mouse button to place your sentence.  The color of the
  301.          text is the currently selected text color set from the COLOR
  302.          menu entry.  To EXIT or abort use the 2 button exit, the
  303.          ESC key only clears the line.
  304.  
  305.     SOUND -   This menu entry allows you to insert canned sound effects
  306.         or music into your graphic.  If you select EFFECTS you will
  307.         get a menu of sound effects, just click on one to hear it.
  308.         To actually place a sound effect into a graphic, just click
  309.         on the one you want then click on ACCEPT.  The MORE entry will
  310.         bring up a alternate menu with different sound effects.
  311.           If you select MUSIC you will be able to point and click on
  312.         a piano keyboard to play mouse music.  To make a tune click
  313.         on RECORD and then click on the piano keys, when done you can
  314.         click on PLAY to hear it.  When you get your tune the way you
  315.         want it click on OK.  You abort a tune by clicking on ABORT.
  316.         You can click on PRACTICE and play all you like for fun.
  317.  
  318.     UNDO -    This menu entry will ERASE the last CONDOR command that
  319.         CPAINT created.  This command may be a visable command or not.
  320.         While you can see a LINE that is not drawn, you can't see a
  321.         color command that is erased.  After chopping the last command
  322.         off in it's buffer CPAINT will have to redisplay the whole
  323.         CONDOR format picture from the beginning to insure that the
  324.         setting or change takes effect.  A word of warning,  if you
  325.         find that you want to erase a PLOTTED OVAL you will only be
  326.         killing one DOT of it at a time.  This can take some time, you
  327.         may want to hand edit it out with a text editor.  A
  328.         Plotted Oval can consist of HUNDREDs of PLOT commands! If you
  329.         hand edit it out watch for the   esc}esc#A   at the end of the
  330.         file and leave that intact.
  331.  
  332.  
  333.     EXTRA -  This entry brings up a sub menu that offers some miscellaneous
  334.            commands and utilities.  Descriptions are as follows:
  335.  
  336.            CPAINT Memory - Displays the Cpaint memory free and the amount
  337.                    of CPAINT memory used.  The amount of memory
  338.                    that CPAINT can use is limited by what is free
  339.                    in the DOS conventional 640K memory.
  340.  
  341.            PAUSE x Sec   - This will create a PAUSE command in the graphic.
  342.                    Move you mouse up and down to vary the length of
  343.                    pause.  Click the left mouse button to accept or
  344.                    do the 2 button EXIT to abort.  Users can ABORT
  345.                    this pause by pressing the CTRL key.
  346.  
  347.            PLAY GRAPHIC  - This will redisplay your drawings from beginning
  348.                    to end.
  349.  
  350.  
  351.                     - 6 -
  352.  
  353.            POSITION CURSOR - Useful for positioning the text cursor below
  354.                    a graphic if you are staying in a graphic mode
  355.                    after drawing.  This is how you would create a
  356.                    BBS menu.  You could have several different BBS
  357.                    menus for each resolution and let the caller
  358.                    select the graphics type at log on, say
  359.                    "CONDOR? C)GA E)GA V)GA <N>o".
  360.                    To place the cursor just move the mouse around
  361.                    and click the left mouse button.
  362.                    A 2 button EXIT will abort this command.
  363.  
  364.     **********************************************************************
  365.     LAST WORDS:  Please pressure your BBS author and terminal authors to
  366.              support this new CONDOR.SYS as a option in their programs.
  367.              Don't let up on them I have made it extremely easy for
  368.              them to do so by making CONDOR a dos CON: device replacing
  369.              ANSI! They have no excuse, they will argue it's slow but
  370.              tell them that you want it as a option in additon to their
  371.              current text output.  Don't let this thing go!  This is
  372.              a COMMON GRAPHICS LANGUAGE that ALL dos based BBSs and
  373.              terminals can share, just like they share ANSI now!
  374.              Their is no cost or fee for them to include CONDOR
  375.              support, they can include the  UNREGISTERED CONDOR.SYS
  376.              in their package.  Interested BBS and terminal authors
  377.              can write me at:
  378.              Larry Mears
  379.              11027 Crestfield Dr.
  380.              Huntsville, Alabama
  381.              35803
  382.  
  383.